home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / comm / net / AMHotlistV1_50.lha / AMHotlist / AMHotlist.doc < prev   
Text File  |  1994-06-27  |  6KB  |  146 lines
  1.  
  2.  
  3. *******************************************************************************
  4.  
  5.                  A M I G A     M O S A I C    H O T L I S T
  6.  
  7.                   AMHotlist V1.50, (c) 1994, Berend Ozceri
  8.  
  9. *******************************************************************************
  10.  
  11. I. Legalities
  12.  
  13.   This program is provided as is, as a public domain program and no guarantees
  14. are made by the author. As Dave Haynie quoted Jimmy Buffet in the A3000/A4000
  15. hardware notes, "What works for me, might work for you." Use this program at
  16. your own risk as I do not assume any responsibility for any physical/electrical
  17. /mental/etc damage caused by this program.
  18.  
  19.   Feel free to distribute this program as much as you want but do not make any
  20. profit from it! If you like it some much that you want to send me a donation,
  21. feel free to do so! ;)
  22.  
  23.   Please report any bugs/problems/suggestions to me. You can contact me at:
  24.   
  25.   E-Mail: bo24@andrew.cmu.edu
  26.  
  27.   Snail-Mail: Berend Ozceri
  28.               Carnegie Mellon University
  29.               Box 4930
  30.               5115 Margaret Morrison
  31.               Pittsburgh, PA 15213
  32.  
  33.   This program uses MUI. MUI is (c) 1993,1994 by Stefan Stuntz.
  34.  
  35.  
  36. II. Changes From V1.00
  37.  
  38.   The most important change is that if you select the "Add to Hotlist" menu
  39. entry under the AMosaic's Rexx menu while you have the hotlist window open, the
  40. hotlist listview will actually be updated.
  41.  
  42.   AMHotlist now has menu entries for its functions.
  43.   
  44.   The program now accurately reflects the hotlists's current state (asleep/
  45. awake) with the normal/busy mouse pointers.
  46.  
  47.   The rest of the changes are mostly user friendliness changes of the program's
  48. error messages. In V1.50 pretty much all errors will pop up a requestor to
  49. tell the user what is wrong and ask for what to do.
  50.  
  51.  
  52. III. Introduction
  53.  
  54.   As you well know, the AMosaic development team has done a great job of
  55. porting Mosaic to the Amiga, bringing an invaluable net resource to the Amiga
  56. world. However, one of the shortcomings of the latest version of AMosaic
  57. (version 1.2) is the support for hotlists (or lack thereof ;) ). Apparently the
  58. developers tried to address this problem by putting in an ARexx script into the
  59. distribution to create pseudo-hotlist support. However, I find the idea of
  60. using a seperate HTML page as a hotlist a major kludge. So what did I do? I
  61. performed a smaller kludge! I wrote an MUI program that can be invoked from
  62. AMosaic (via ARexx) and will give you complete hotlist control.
  63.  
  64.  
  65. IV. Installation
  66.  
  67.   The installation is straightforward. Copy the executable AMHotlist to any
  68. directory you want. Add the following lines to your ENVARC:Mosaic/Prefs:
  69.  
  70. RexxMacro1 Add to Hotlist | "ADDRESS COMMAND 'C:RUN <>NIL: MOSAIC:AMHotlist QUICKADD'"
  71. RexxMacro2 Hotlist... | "ADDRESS COMMAND 'C:RUN <>NIL: MOSAIC:AMHotlist'"
  72.  
  73. (Make sure you replace MOSAIC:AMHotlist with wherever you decide to install the
  74.  executable in your system. For example, if you install the AMHotlist program
  75.  in your C: directory, replace the MOSAIC:AMHotlist in those lines with
  76.  C:AMHotlist)
  77.  
  78.   Copy the .mosaic-hotlist-default file to your ENVARC: directory as follows:
  79.  
  80.     COPY .mosaic-hotlist-default ENVARC:Mosaic
  81.  
  82.   Copy the ENVARC:Mosaic directory to ENV:Mosaic as follows:
  83.  
  84.       COPY ENVARC:Mosaic ENV:Mosaic
  85.  
  86.   You are set!
  87.  
  88.   (Note: The hotlist program requires you have a MUI, but since you are already
  89. using AMosaic that step should already have been taken care of.)
  90.  
  91.  
  92. V. Usage
  93.  
  94.   Start AMosaic. Under the Rexx menu you should see two entries "Add to
  95. Hotlist" and "Hotlist..." Select "Hotlist..." The hotlist window will open on
  96. your default MUI screen (this is normal for any MUI program that does not have
  97. any configuration saved). If you are running AMosaic on a screen other than the
  98. default screen, close the hotlist window, start up MUIPrefs and set
  99. AmigaMosaic-Hotlist's screen prefs so that it opens on that screen too. Then
  100. reopen the window. If you copied a .mosaic-hotlist-default file to your
  101. ENV:Mosaic directory, it should automatically have been loaded by now.
  102.  
  103.    i) Adding New Entries
  104.  
  105.      There are two ways to add new entries to the hotlist. The first way is by
  106.    using the "Add" button in the hotlist window. If you click on "Add" a dialog
  107.    window will come up preloaded with the information regarding the current
  108.    page loaded into AMosaic. If you want to add that page as is, just click on
  109.    "Done", and it will be added. If you want, you can do editing on the "Title"
  110.    and "URL" fields before you click on "Done". If you decide not to add, just
  111.    click on "Cancel"
  112.  
  113.      The other way to add an entry to the hotlist is by using the "Add to
  114.    Hotlist" menu option under AMosaic's Rexx menu. If you perform this menu
  115.    selection, AMosaic's current page will be added to your hotlist without
  116.    bringing up any dialog windows.
  117.  
  118.      Note that everytime you add an item, AMHotlist will update the
  119.    .mosaic-hotlist-default file in your ENVARC: and ENV: directories. 
  120.      
  121.  
  122.    ii) Deleting Entries
  123.  
  124.      Deleting a hotlist entry is easy. Just select the hotlist entry from the
  125.    listview and click on "Delete."
  126.  
  127.  
  128.    iii) Editing Entries
  129.  
  130.      If you decide at any point to change anything about a hotlist entry that
  131.    you already have, use the "Edit" button. Selecting a hotlist entry and
  132.    clicking on "Edit" will bring up an editing dialog. Edit the entry as you
  133.    wish and click on "Done" if you want the changes to take effect. If you want
  134.    to scratch the changes, click on "Cancel"
  135.  
  136.      The editing window is asynchronous from the rest of the program so you can
  137.    be double-clicking on entries to jump to while the edit window is open.
  138.  
  139.  
  140.    iv) Jumping to Entries
  141.  
  142.      If you want to jump to an entry, just double click on it! Presto! You are
  143.    there. You will realize that when you perform a jump, the hotlist window
  144.    will be put to sleep until AMosaic confirms via ARexx that the jump has
  145.    worked.
  146.